text: Make editable signals work again

Since the big editable reorg, GtkText was not emitting
::insert-text and ::delete-text, as is expected of
editables. We want to use those signals for a11y
change notification, so make them work again.

atspi: Set placeholder-text attribute

This is how GTK3 passes placeholder-text to orca,
and it works - orca reads it.

atspi: Implement EditableText interface for the entry wrappers

Drop the EditableText implementation for GtkText,
and implement it for all the wrapper widgets instead.

accessible: Add some docs

Explain briefly how a11y works for entry wrappers
(since I won't remember a few months from now).

atspi: Implement Text interface for the entry wrappers

Drop the Text implementation for GtkText, and implement
it for all the wrapper widgets instead.

spinbutton: Implement GtkAccessible

This copies what was done for GtkEntry: get
the focused state from the GtkText within.

We also add a private getter for the text widget,
which was missing here.

passwordentry: Implement GtkAccessible

This copies what was done for GtkEntry: get
the focused state from the GtkText within.

searchentry: Implement GtkAccessible

This copies what was done for GtkEntry: get
the focused state from the GtkText within.

entry: Implement GtkAccessible

Override the get_platform_state vfunc to get
the focused state from the GtkText widget within.

text: Ignore text widgets for a11y

We want to implement the Text interface on the
wrapper entries.

atspi: Use gtk_accessible_get_platform_state

accessible: Add gtk_accessible_get_platform_state

As a companion to go with the platform_change api,
add a gtk_accessible_get_platform_state() function
that can be used by backends to get the platform
state.

This is in preparation for making entries inherit
their focus states from the text widget within.

atspi: Use gtk_accessible_should_present

Replace explicit visibility check by this
more general method of determining whether
an accessible should be presented to the
a11y layer.

accessible: Add a way to hide accessibles

Similar to gtk_widget_should_layout(), add a
gtk_accessible_should_present() function that backends can
use to determine whether an accessible should be presented
or not.

Ways to make a widget not presented in a11y:
- hide the widget
- set its role to NONE
- make it have a NULL AT context

We will use this in future to hide the GtkText inside
an entry, since the Text implementation will be done
by the wrapper.

Cosmetics

atspi: Treat all entries the same for collecting state

We are determining editable state based on the
accessible role (although we could make it platform
state now), so cover all the roles that we use for
entry wrappers.

atspi: Fix collecting states

This is somewhat embarrassing.

Fix the build

atspi: D-Bus methods return tuples

I've learned this the hard way: When returning a
value from a D-Bus call, the variant construct must
*always* be g_variant_new ("(...)"...

Don't unref a floating variant

It gets consumed somewhere along the way.

atspi: Unregister objects on the bus

When a widget is going away, we need to remove
the context from the bus, or else ATs might have
the idea to call methods on them, leading to badness.

atspi: Emit property changes for focus

With this orca, actually speaks \o/.  Sadly, it only
says 'gtk modelbutton widget' so far, but its a start.

atspi: Cosmetics

Use simple wrappers instead of opencoding bit twiddling
all over the place.

widget: Notify a11y of focus changes

This is using the new 'platform changes' mechanism
to tell the a11y backends when focus changes.

a11y: Pass on platform changes

Add an enum for 'platform changes' to the at context
change notification mechanism. This will let us pass
along things that ARIA considers 'platform state' such
as focus or editability. The difference between the
platform state and other ARIA states is that we don't
keep the platform state separately in the at context
- backends are expected to just query the widgets.

This is just about avoiding notify listeners for
change notification.

atspi: Be more careful about indexes

Don't return a number for IndexInParent when we
don't have one.

atspi: Set some more atspi states

Pass on more of the states that are represented
as properties in aria: modal, multi-line, orientation.

Pass orientation property to accessible

We should set the accessible properties we have,
where they make sense. So set orientation, if the
widget is orientable.

wip: Emit StateChanged signals

This is not fully baked, but it is enough to make accerciser
notice when a text entry goes from editable to not editable.

atspi: Derive readonly state from aria properties

We can use the read-only property, together with the
accessible role, to determine whether to set editable
and read-only states for at-spi. This lets us avoid
directly poking at the widgets.

text: Set the readonly accessible property

This mirrors what we already do for GtkTextView.

atspi: Set editable state

ATs look at not just the implemented interfaces, but
also the states to decide what to do. It turns out that
the EditableText interface is only used by accerciser
if the editable state is set. So set it.

atspi: Implement EditableText interface

Implement EditableText for GtkText and GtkTextView.

atspi: Break out the Value implementation

This isn't necessarily very big, but it keeps
the widget checks out of gtkatspicontext.c, and
it is a nice pattern.

atspi: Break out the Text implementations

Move the implementation of the Text interface
to its own source file, and split it up along
widget lines, to avoid it becoming too messy.

scalebutton: Set accessible value properties

This is what we did in GTK 3.

paned: Set accessible value properties

This is what we did in GTK 3.

Simplify GetInterfaces handling

It is error prone to keep the same conditions in sync
in two places. Instead, just assemble the list of interfaces
as we register objects, and use when GetInterfaces is called.

atspi: Implement Value for more widgets

Apply the Value implementation to the widgets where
we had one in GTK 3: GtkLevelBar, GtkRange, GtkScaleButton,
GtkSpinButton, GtkPaned, GtkProgressBar. To make these
work, the widgets need to set the accessible value properties.

atspi: Implement Value interface for ranges

atspi: Implement Text interface for text views

With this, all relevant widgets support the
Text interface.

atspi: Add textview utilities

These are very similar to the pango utilities,
and are copying code from the textview accessible
implementation in GTK 3.

atspi: Export more pango utils

We are going to reuse some of the code that does
the pango -> atspi attribute conversion for text
tags.

atspi: Implement text for GtkText widgets too

There is some open question here whether the interface
should be implemented on the outer or the inner widget
of the entry-text pairs. For now, our hand is forced,
since only GtkText provides access to the layout that
we need for implementing many of the interface methods.

atspi: Implement Text interface for labels

This is a not-quite-complete implementation of the
Text interface for GtkLabel. The missing parts are
anything around extents and positions, as well as
the ScrollSubstring apis.

atspi: Add pango utilities

This code is more or less a direct copy of what
we had in gtkpango.c in 3.x.

atspicontext: Fix GetIndexInParent for toplevels

For toplevels, we need to return the index in the
list of toplevels, since that is what GtkAtspiRoot
is using.

atcontext: labelled-by has a reference list

This is unclear - our docs state that all the
relations have value type reference, but in fact
they all have value type reference list.

atspicontext: Implement GetRelationSet

This translates relations as far as the match.

I'm not sure yet what we can do about the fact that
atspi expects relations to be bidirectional (ie have
label-for *and* labelled-by) while aria has only one
direction.

atspiroot: Stub out GetRelationSet

This needs to be fully implemented, for now sending
an empty relation set back prevents accerciser from
getting hung up.

atspi: Add the AtspiRelationType enum

This is what we need to map the aria relation
types to.

Move atspi enums to gtkatspiprivate.h

Add a GetInterfaces method

It turns out that accerciser depends on this undocumented
method that is not in the xml at all, otherwise interface
sections in the accerciser ui never get enabled.

Don't pass NULL to g_variant_new_string

That does not work.

atspi utils: Fix an oversight

gtk_accessible_role_to_atspi_role must always return
an atspi role. The fallback was returning an aria
role.

Fixup: Add a forgotten #pragma once

a11y: Convenience API for referencing ATSPI root node

We turn the root node into a reference fairly often, so it's worth it to
have a utility function that does this for us.

a11y: Add utility function for null refs

ATSPI was written for CORBA, which allows passing around "nil"
as valid object references.

atspicontext: Implement GetState

Translate the aria states to at-spi's interpretation
of atk states.

atspiroot: Fix GetState implementation

When the GetState signature says 'au', it actually
means a bitset that is sent as a pair of 32bit integers.

atspiroot: Implement GetIndexInParent

Just for good measure

atspicontext: Implement GetIndexInParent

This is needed for ATs to take our tree seriously.

atspicontext: Implement more accessible api

Implement GetChildAtIndex, GetChildren and ChildCount.

atspiroot: Implement GetChildren

No surprises here.

atspiroot: Don't leak references

The reffing getter trap, lurking behind g_list_model_get_item().

atspiroot: Implement GetLocale

atspicontext: Print out the a11y bus address

Make our debug spew useful: Having the bus address
makes it easy to jump on the a11y bus to look around
with dbus tools.

a11y: Localise the role name of the root node

a11y: Register the Accessible interface on all AtSpiContext instances

This is not a complement implementation.

a11y: Implement more ATSPI methods on the root node

a11y: Add method to extract desktop data

We are going to need the desktop name and path to populate the parent
property of AtSpiContexts associated to top level widgets.

a11y: Validate the DBus context path

UUIDs use dashes to separate the various blocks; unfortunately, this
results in an invalid DBus object path. Replace the dashes with an
underscore.

a11y: Turn accessible roles to string

Add a simple utility function to turn GtkAccessibleRole values into the
appropriate string, including localization.

a11y: Convert GTK roles to ATSPI ones

There's not a precise, 1:1 mapping between the newer ARIA roles and the
older ATSPI ones. We make do with what we have.

a11y: Compute the label for a GtkATContext

The ARIA spec defines the mechanism for determining the name of an
accessible element—see §4.3 of the WAI-ARIA spec.

We follow the specification as much as it makes sense for GTK to do
so:

 1. if the element is hidden, return an empty string
 1. if the element has a labelled-by relation set, retrieve the
    label of the related element
 2. if the element has a label property set, use the value of
    the property
 3. if neither labelled-by nor label attributes are set, we use
    the role to compute the name:
   - for a `range` role, we return the contents of the value of
     the `value-text` or `value-now` properties
   - for any other role, we return a textual representation of
     the GtkAccessibleRole enumeration value

tests: Use the test ATContext for every test

Otherwise we're going to need a full desktop session in order to run the
test suite.

a11y: Return the ATSPI role for the root element

a11y: Add AT-SPI cache object

Right now, the cache is unused, and we still need to implement the
serialisation method and emit the signals.

a11y: Ignore widgets during destruction

There's no point in creating a GtkATContext when a widget is getting
destroyed.

a11y: Register the accessible root object

When we create the first AT-SPI context we also need to register the
accessible root on the accessibility bus. The accessible root object is
the main entry point of an accessible application, and it holds the
global state to present to the ATs that connect to the bus.

a11y: Add a display to GtkATContext

Since we need to check at run time what kind of AT context to use, we
need a hook into the whole GDK backend machinery. The display connection
seems to be the best choice, in this case, as it allows us to determine
whether we're running on an X11 or Wayland system, and thus whether we
should create a GtkAtSpiContext.

This requires some surgery to fix the GtkATContext creation function, in
order to include a GdkDisplay instance.

a11y: Add dummy AT-SPI context

Does not do anything, at the moment, but it's going to get filled out
soon.

The backend is selected depending on the platform being compiled in;
since we're using AT-SPI on X11 and Wayland, and we don't have other
accessibility implementations, we currently don't care about run time
selection, but we're going to have to deal with that.

a11y: Add the AT-SPI DBus descriptions

And generate the code for the DBus interfaces.

We don't want the full object manager experience, here, because we're
going to have a single object responding to various interfaces and
remote method calls. For this reason, we're not using the gnome module
in Meson to call gdbus-codegen for us: we need to use the interface info
command line arguments, and those are not available from Meson.

Use test AT context with installed tests

Otherwise we're going to need an AT-SPI service on the session, and the
accessibility bus.

Merge branch 'ebassi/for-master' into 'master'

Ebassi/for master

See merge request GNOME/gtk!2683

Generate introspection for GdkWayland API

Like we do for GdkX11. We can't use all of the public C API, but we can
expose enough type information to allow non-C developers to actually
check if they are running the Wayland GDK backend or not—plus some
additional Wayland-specific API.

Add type annotations for GdkWayland API

The GdkWayland API takes generic GDK types and performs a run time
check, which means we need to properly annotate the actual expected
type in order to have methods recognised as such.

Skip GdkWayland symbols that use wayland-client types

The wayland-client API does not have introspection annotations, so we
can't use these types anyway.

Updated Lithuanian translation

Merge branch 'wip/chergert/gdk-macos-fixes' into 'master'

various build fixes for GDK/GTK on macos

See merge request GNOME/gtk!2680

Update Polish translation

Updated Czech translation

macos: port gtk to GDK_WINDOWING_MACOS

For the various uses of GDK_WINDOWING_QUARTZ, we need to use
alternatives from GDK_WINDOWING_MACOS.

Some minor loss of functionality is here, such as icons sent with
application menus. That can certainly be added back at a future
point.

gtk: use GDK_WINDOWING_MACOS in gentypefuncs.py

gdk: remove quartz subdirectory from backends

macos: add key equivalent helper

This is needed by quartz code in gtk/.

macos: remove workaround for scroll delta

This gets handled differently in gtk/ and so we shouldn't translate it here.

macos: track various changes in GDK

macos: lookup NSEvent by translated GdkEvent

This will be needed by the quartz imcontext.

macos: move input method names to private header